home *** CD-ROM | disk | FTP | other *** search
/ Best of Shareware / Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso / mac / DOS / UTILITY / EZIP11E / EZIPMAN.DOC < prev    next >
Text File  |  1993-08-30  |  15KB  |  284 lines
  1.  
  2.                        EZIP Version 1.1E      9/1/93
  3.  
  4.  
  5. "EZIP" is "PROMPT-driven".  Just answer the prompts and supply the necessary
  6. information.  <ESC> exits to the Main MENU at any time.
  7.  
  8. ============================================================================
  9. COMMAND-LINE PARAMETERS or "How to switch to your working directory when you
  10. invoke EZIP...."
  11. ============================================================================
  12.  
  13. It's easiest to use "EZIP" if you first move to the subdirectory where you
  14. plan to ZIP or UNZIP files.  (Otherwise, you have to type the full path
  15. name for the ZIPFILE).  "EZIP" allows you to choose the subdirectory where
  16. you will be using "EZIP" in two (2) ways:
  17.  
  18.      1)  Type the desired subdirectory (full PATH NAME if not on current
  19.      drive) after "EZIP" (as a command-line parameter:)
  20.  
  21.                        (ie,;  EZIP B:\sub1\sub2...)
  22.  
  23.      2)  Selecting the subdirectory with the VIEW DIRECTORY option on the
  24.      MAIN EZIP MENU           (Type:  <I> ).
  25.  
  26. ===========================================================================
  27.                                MAIN MENU OPTIONS
  28. ===========================================================================
  29.  
  30. The first letter of each menu item selects that item and is highlighted
  31. (except for the Directory View/Change option; the 'I' is highlighted.).
  32. After you choose a letter from the top menu, a second sub menu pops up with
  33. the choices listed below.
  34.  
  35.      < > = TOP MENU CHOICE
  36.      { } = {SUB MENU CHOICES}
  37.  
  38. 1.   <Z>ip Files:  "Zip" ALL the files in a directory, or only those you
  39.           SPECIFY (You can use DOS wildcards '?' and '*' or list them
  40.           individually.).  "Zipping" (compressing) files, creates
  41.           copies of the files inside a single archive file called the
  42.           zipfile.  This zipfile can be considerably smaller than the
  43.           original files depending on the formats of the originals.
  44.           (Binary files ('.com','.exe') compress less than text files.
  45.           'GIF' format graphics files are already compressed.)  Zipping
  46.           does nothing to the original files.  If you were using some
  47.           product other than EZIP, you'd have to go back afterwards and
  48.           delete the original files manually (if your goal was to free
  49.           up more space).  EZIP gives you the option to delete the
  50.           source files immediately, or use the DELETE FILES option later.
  51.           (NOTE:  When creating a ZIPFILE, you must have enough room on
  52.           the disk to hold BOTH the originals and the new zipfile,
  53.           otherwise PKZIP won't have enough disk space to create the
  54.           temporary files it needs during archiving.)
  55.  
  56.      {Sub Menu Choices}
  57.        {A}ll Files:  Zips all the files in the current subdirectory.  This
  58.             creates a zipfile (you pick the name, but it will have a '.ZIP'
  59.             extension.) with compressed copies of all the files.  Then EZIP
  60.             prompts you to Delete the original files.  You can either say
  61.             YES and EZIP will delete all the files in the directory except
  62.             the ZIPFILE, OR, you can say NO and use the DELETE FILES option
  63.             to delete them later.
  64.        {S}pecified Files:  Zips only those files you specify.  There are
  65.             three ways to do this:
  66.  
  67.           1)  List each file (file1 file2 ...fileX)
  68.           2)  List the files using DOS wildcards (i.e.; Client1.*...)
  69.  
  70.                    (eg.  "*.com CompanyA.* \otherdir\file1.ext ...")
  71.  
  72.           Note:  Each file is separated from the previous by a space.
  73.           This listing would zip all files with the ".com" extension,
  74.           plus all files named "companyA.???" no matter what the
  75.           extension, and the file "file1.ext" from directory
  76.           "\otherdir".
  77.  
  78.           You may also zip all of a particular file name EXCEPT those
  79.           you specify by EXCLUDING files.  For example, to zip ALL files
  80.           in the current directory except the ".BAK" files, and a file
  81.           named "client1.doc", at the "FILE(S)" prompt, type:
  82.           
  83.                          -X*.bak -Xclient1.doc <RTN>
  84.  
  85.           To ZIP all ".DOC" files except those from CLIENT3?, (like
  86.           Client3a.doc, client3B.doc, client32.doc....)you'd type the
  87.           following:
  88.  
  89.                          *.doc -Xclient3?.doc
  90.                
  91.           3)   Create a LIST FILE, which contains the list of those
  92.           files to be Zipped.  This is useful if you routinely
  93.           zip the same files (ex:  to back up your work on a
  94.           particular client or project each day.).
  95.  
  96.           With an ASCII text editor, create a LIST FILE with the following
  97.           format:
  98.  
  99.                     *.doc
  100.                     client??.wpd
  101.                     -x*.bak
  102.                     data.lst
  103.                     .
  104.                     .  <=  (other file descriptors or names)
  105.                     .
  106.  
  107.  
  108.           This LIST FILE would cause all  '.DOC' files, all 'Client??.WPD'
  109.           files, and the 'data.lst' file to be zipped, but eXclude the
  110.           '.BAK' files.  To invoke this LIST FILE, (assume its name was
  111.           FILE.LST) at the "FILE(S)" prompt, type:
  112.  
  113.                     @File.lst  <RTN>
  114.  
  115. 2.   <U>nzip:  Used to UNZIP or extract files from a zipfile. This process
  116.           actually creates copies of the compressed files inside the
  117.           zipfile.  You can either extract ALL the files contained in a
  118.           zipfile, or SPECIFY those you wish to extract ('UNZIP').  You
  119.           may also specify the directory where you'd like these files to
  120.           end up.  It doesn't have to be the same directory that contains
  121.           the zipfile.  (This is handy for unzipping files from a floppy
  122.           disk back onto your hard disk.)
  123.        
  124.     {Sub Menu Choices}   
  125.        {A}ll:  Unzips all files inside the specified zipfile to the
  126.             directory you specify (or to the current directory if you don't
  127.             pick one.)
  128.        {S}pecified Files:  Allows you to extract specific files from a
  129.             zipfile.  Use the same three techniques at the "FILE(S)" prompt
  130.             as used to"ZIP SPECIFIED FILES" (#1, above).
  131.  
  132. 3.   <V>iew Files:  This choice allows you to select one of the following
  133.                three options:
  134.  
  135.     {Sub Menu Choices}
  136.        {L}ist Zipfile Contents:  Lists all files contained in the specified
  137.             zipfile.  If the list in longer than 23 lines, the display
  138.             pauses every 23 lines.
  139.        {C}ontents of particular file inside a Zipfile:  Use this option to
  140.             extract to the screen any file contained in a zipfile.  This is
  141.             handy for viewing README files that have been archived, without
  142.             having to first UNZIP them.
  143.        {V}iew File:  This option allows you to view any file using either
  144.             EZIP's own included EZVWR.EXE or an external file viewer program 
  145.             of your choice (like LIST.COM).  This has nothing to do with 
  146.             Zipping and Unzipping files.  It's just included here for your
  147.             convenience.
  148.  
  149. 4.   {D}elete Files:  Use this choice to delete files from any directory or
  150.           to remove a file from a zipfile (so it is no longer contained
  151.           there.).  This option is useful for cleaning up your disk.  It
  152.           first lists the directory then allows you to delete those files
  153.           you no longer need (you can use DOS wildcards here also).
  154.  
  155.     {Sub Menu Choices}
  156.        {F}iles:  Use this to delete files from any directory.  The current
  157.             directory is displayed in a scrollable window, along with a 
  158.             prompt for file(S) to be deleted.
  159.        {D}elete files from a Zipfile:  This removes files from a zipfile;
  160.             usefull for deleting obsolete or out-of-date files and reducing
  161.             the zipfile size.
  162.  
  163. 5.   <C>onvert Files:  Actually creates a second copy of a normal zipfile 
  164.           (".ZIP" extension) which has the ability to unpack itself without
  165.           PKUNZIP.  This second copy has a ".EXE" extension.  This is useful 
  166.           for passing files to a friend who doesn't yet have PKZIP and EZIP.  
  167.           The other person merely types the file name and it unpacks itself, 
  168.           creating copies of the files inside automatically.  The original 
  169.           ZIPFILE remains in the directory so you need to have sufficient room
  170.           for both of them on the disk or PKZIP won't be able to create the
  171.           second one.
  172.  
  173.           Question:  This sounds handy, right?  Why wouldn't you do this to
  174.           ALL your files?  Two reasons:  First, these files are larger than
  175.           a normal zipfile.  Second, you can't easily manipulate them to view 
  176.           their contents or extract files.  You have to unpack everything or 
  177.           nothing.
  178.           
  179.     {Sub Menu Choices}  
  180.        {Z}ipfile-to-EXE:  Create a self-extracting copy of a normal zipfile.
  181.        {E}XE-to-Zipfile:  Converts a self-extracting zipfile back into a
  182.             normal zipfile.  (No secret how.  This routine just automatically 
  183.             unpacks the file, re-zips it, and deletes the original ".exe" 
  184.             file.  If you don't want the original deleted, make a copy of it 
  185.             first!)
  186.  
  187. 6.   D<I>rectory View/Change:  Displays the current directory and allows
  188.           you to move about your disk to look for files.  Whichever directory 
  189.           you're in when you return to the main menu, will become the current 
  190.           (or default) directory.
  191.  
  192.           <Shift-Tab> changes the directory to the parent of the current
  193.           directory.  It's the same as typing ".." for directory name or
  194.           "CHDIR .." at the DOS prompt.  (If your current directory is:
  195.           C:\sub1\sub2, you will move to "C:\sub1" and the contents of that
  196.           directory will be displayed.)
  197.           
  198.           If you type a name without any backslashes "\", EZIP assumes the
  199.           directory is off the current directory (just like DOS).  You can
  200.           even switch disks by typing the full path to the desired
  201.           directory.
  202.  
  203. 7.   <O>ther Useful Options:  This option gives you access to the following
  204.           features:
  205.  
  206.     {Sub Menu Choices}
  207.        {R}eadme:  Displays this README file via "EZVWR" or your own
  208.             external file viewer for easy reference.  This is the
  209.             "Detailed" version of the "ON-LINE HELP".
  210.        {M}ake New Directory:  Create directories, including multi-level
  211.             directories.  This option follows the DOS rules for creating
  212.             directories. If you specify the directory name without a
  213.             leading back-slash (\), the directory will be created in the
  214.             current subdirectory.  If you include the backslash (\), you'll
  215.             create it off the root directory.
  216.        {H}elp:  The abbreviated "ON-LINE HELP".
  217.        {A}dd Zipfile Comments:  A handy way to add notes to a zipfile so
  218.             that any time you "VIEW" it, you can see this information.  Add
  219.             historical information or references using either your own
  220.             external editor (DOS 5.0's "EDIT.COM" works fine), directly from 
  221.             the console, (or by inserting a previously-created ASCII text file).  
  222.             If you haven't specified an external editor during installation, 
  223.             you'll be prompted to add the comments directly from the keyboard
  224.             or by inserting a file.  For best appearance, start with a <RETURN>
  225.             then type your comments, remembering to add <RETURN>'s at the end 
  226.             of each line.  When finished, type <CONTROL-C> (^C).
  227.        
  228.             This works OK for shorter comments but is tiresome for longer
  229.             ones. If you create the ASCII text file ahead of time, EZIP allows 
  230.             you to insert it rather than typing the comments directly.
  231.             If the ASCII comment file is NOT in the current directory, type its 
  232.             full path name.  Again, when creating this file, start with a 
  233.             <RETURN> for an empty line.  This gives the best appearence on 
  234.             screen.
  235.  
  236.        {S}trip Zipfile comments:  This option quickly removes zipfile
  237.             comments.  The comments are not saved to a file but simply
  238.             deleted.  
  239.        
  240.        {C}ontact the Author:  Instead of a sign-off screen or general
  241.             "pester" screen on startup, I've put all the information you
  242.             need to contact me with your comments here.  It includes the
  243.             BBS's where I check my mail and my mailing address.  I'd really
  244.             like to hear from you.  As with all shareware, use EZIP as long
  245.             as you need to before deciding whether you really like it.
  246.             Send your comments whether you're ready to register or not.
  247.             The only enticement I can offer to registration, is that I
  248.             maintain a list of all "known" users and give them first shot
  249.             at any upgrades/bug-fixes/ and enhancements.  (Plus a discount
  250.             on the next whole-number upgrade; EZIP 2.0.)  You'll get any
  251.             changes to EZIP 1.0 A-Z for free.
  252.        
  253. 8.   <Q>uit to DOS:  Exit EZIP to your operating system (DOS,WINDOWS).
  254.  
  255.                   ********* ADDITIONAL NOTES ***********
  256.  
  257. Any time your choice involves manipulating a zipfile, EZIP will give you a
  258. list of those Zipfiles in your current directory.  If there are none, it will
  259. tell you.  If your next step involves a file inside a zipfile, (for example:
  260. viewing a file inside a zipfile), EZIP will display a list of the zipfile's
  261. contents.  Finally, if your next step involves files of unknown type, EZIP
  262. displays the current directory listing.
  263.  
  264. UNZIPPing A FILE:  There is no need to select the DESTINATION SUBDIRECTORY
  265.           for the files prior to starting the UNZIP process.  "EZIP" will
  266.           propmpt for the DESTINATION subdirectory (full path name).
  267.           Hitting <ENTER> will select the current directory as destination.
  268.  
  269. TROUBLE VIEWING OR UNZIPPING A FILE:  If you can't view or unzip a file
  270.           that you know or suspect has file comments inserted by someone
  271.           else, use the "STRIP COMMENTS" option to eliminate them.  Some
  272.           Comment-Insertion utilities produce files that DOS does not
  273.           handle well.  If the zipfile has been corrupted, (this can happen
  274.           to ANY file, it's not something that only happens to zipfiles.)
  275.           use PKZIPFIX.
  276.  
  277. REQUIRED FILES:  EZIP requires the following PKZIP files to function fully:
  278.           PKZIP.EXE, PKUNZIP.EXE and ZIP2EXE.EXE.  If you don't have the
  279.           ZIP2EXE file, the only function you lose is the ability to create
  280.           a self-extracting zipfile.  All other EZIP features will function
  281.           normally.
  282.  
  283.       >>>>>>>>>>>>>>>>>>>>>>> END OF FILE <<<<<<<<<<<<<<<<<<<<<<
  284.